Export top matching Vacancies for Employees.
curl --request POST \
  --url https://{tenant_name}.{region}.techwolf.ai/export/employees/matching_vacancies \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "limit": 10,
  "match_limit_per_entity": 10,
  "score_min_threshold": 0.7,
  "starting_after": "a3903505-eb84-42dc-a79f-5e7b1fe897b7",
  "filters": [
    {
      "filter": "max_geo_distance",
      "max_geo_distance": 50
    },
    {
      "filter": "multi_max_geo_distances",
      "multi_max_geo_distances": [
        {
          "max_geo_distance": 20,
          "location": {
            "lat": 51.34,
            "lng": 3.15
          }
        },
        {
          "max_geo_distance": 20,
          "location": {
            "country": "BE",
            "postal_code": 9000
          }
        }
      ]
    },
    {
      "filter": "language",
      "max_overqualification": 2,
      "max_underqualification": 1
    },
    {
      "filter": "last_updated",
      "value": "2022-01-01",
      "operator": "lt"
    },
    {
      "filter": "custom_property_equal",
      "from_entity_property": "desired_wage",
      "to_entity_property": "wage"
    },
    {
      "filter": "custom_property",
      "property_name": "direct_manager",
      "property_value": "John Doe"
    },
    {
      "filter": "custom_property_is_in",
      "from_entity_property": "required_drivers_license",
      "to_entity_property": "drivers_licenses"
    },
    {
      "filter": "custom_property_is_in_list",
      "property_name": "drivers_license",
      "possible_values": [
        "C",
        "CE"
      ]
    },
    {
      "filter": "custom_property_contains",
      "from_entity_property": "shift_regime_codes",
      "to_entity_property": "desired_regime"
    },
    {
      "filter": "custom_property_list_overlap",
      "from_entity_property": "desired_industries",
      "to_entity_property": "industries"
    },
    {
      "filter": "custom_property_contains_element",
      "property_name": "industries",
      "property_value": "electronics"
    },
    {
      "filter": "external_id_is_in_list",
      "external_ids": [
        "c350500-eb84-42dc-a79f-5e7b1fe897b7",
        "b450500-eb84-42dc-a79f-5e7b1fe897c8"
      ]
    }
  ],
  "weights": [
    {
      "weight": "skills_match",
      "value": 1
    },
    {
      "weight": "desired_functions",
      "value": 0.03
    },
    {
      "weight": "geo_distance",
      "value": 0.1,
      "full_score_distance": 5,
      "zero_score_distance": 50
    },
    {
      "weight": "language",
      "value": 0.1,
      "max_overqualification": 2,
      "max_underqualification": 3
    },
    {
      "weight": "custom_property",
      "value": 0.04,
      "property_name": "yearly_salary",
      "operator": "gte",
      "property_value": 45000
    },
    {
      "weight": "custom_property_is_in",
      "value": 0.06,
      "from_entity_property": "desired_work_regime",
      "to_entity_property": "offered_work_regimes"
    },
    {
      "weight": "custom_property_is_in_list",
      "value": 0.05,
      "property_name": "region",
      "possible_values": [
        "Flanders",
        "Wallonia"
      ]
    },
    {
      "weight": "custom_property_contains",
      "value": 0.07,
      "from_entity_property": "sectors",
      "to_entity_property": "desired_sector"
    },
    {
      "weight": "custom_property_contains_element",
      "value": 0.04,
      "property_name": "industries",
      "property_value": [
        "Electronics",
        "Aviation"
      ]
    },
    {
      "weight": "custom_property_list_overlap",
      "value": 0.04,
      "from_entity_property": "desired_industries",
      "to_entity_property": "industries"
    }
  ]
}'
{
  "has_next": true,
  "next_starting_after": "a3903505-eb84-42dc-a79f-5e7b1fe897b7",
  "records": [
    {
      "employee_id": "employee_1_id",
      "matches": [
        {
          "vacancy_id": "vacancy_1_id",
          "score": 0.87657
        },
        {
          "vacancy_id": "vacancy_2_id",
          "score": 0.82341
        }
      ]
    }
  ]
}

Authorizations

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Query Parameters

​
response_format
enum<string>
default:simple

If set to explained, the response will include an explanation of the match.

Available options:
simple,
explained
Example:

"explained"

Body

application/json

The maximum number of entities to calculate matches for The maximum number of matches to return per entity The minimum threshold score to apply to match results Pagination parameter for cursor-based pagination List of filters to be applied on the entities before matching List of weights to be applied during matching

​
filters
(max_geo_distance · object | multi_max_geo_distances · object | language · object | last_updated · object | custom_property_equal · object | custom_property · object | custom_property_is_in · object | custom_property_is_in_list · object | custom_property_contains · object | custom_property_contains_element · object | custom_property_list_overlap · object | external_id_is_in_list · object | exclude_match_feedback · object)[]
required
Example:
[
  {
    "filter": "max_geo_distance",
    "max_geo_distance": 50
  },
  {
    "filter": "multi_max_geo_distances",
    "multi_max_geo_distances": [
      {
        "max_geo_distance": 20,
        "location": { "lat": 51.34, "lng": 3.15 }
      },
      {
        "max_geo_distance": 20,
        "location": { "country": "BE", "postal_code": 9000 }
      }
    ]
  },
  {
    "filter": "language",
    "max_overqualification": 2,
    "max_underqualification": 1
  },
  {
    "filter": "last_updated",
    "value": "2022-01-01",
    "operator": "lt"
  },
  {
    "filter": "custom_property_equal",
    "from_entity_property": "desired_wage",
    "to_entity_property": "wage"
  },
  {
    "filter": "custom_property",
    "property_name": "direct_manager",
    "property_value": "John Doe"
  },
  {
    "filter": "custom_property_is_in",
    "from_entity_property": "required_drivers_license",
    "to_entity_property": "drivers_licenses"
  },
  {
    "filter": "custom_property_is_in_list",
    "property_name": "drivers_license",
    "possible_values": ["C", "CE"]
  },
  {
    "filter": "custom_property_contains",
    "from_entity_property": "shift_regime_codes",
    "to_entity_property": "desired_regime"
  },
  {
    "filter": "custom_property_list_overlap",
    "from_entity_property": "desired_industries",
    "to_entity_property": "industries"
  },
  {
    "filter": "custom_property_contains_element",
    "property_name": "industries",
    "property_value": "electronics"
  },
  {
    "filter": "external_id_is_in_list",
    "external_ids": [
      "c350500-eb84-42dc-a79f-5e7b1fe897b7",
      "b450500-eb84-42dc-a79f-5e7b1fe897c8"
    ]
  }
]
​
weights
(skills_match · object | desired_functions · object | geo_distance · object | language · object | custom_property · object | custom_property_is_in · object | custom_property_is_in_list · object | custom_property_contains · object | custom_property_contains_element · object | custom_property_list_overlap · object)[]
required
Example:
[
  { "weight": "skills_match", "value": 1 },
  {
    "weight": "desired_functions",
    "value": 0.03
  },
  {
    "weight": "geo_distance",
    "value": 0.1,
    "full_score_distance": 5,
    "zero_score_distance": 50
  },
  {
    "weight": "language",
    "value": 0.1,
    "max_overqualification": 2,
    "max_underqualification": 3
  },
  {
    "weight": "custom_property",
    "value": 0.04,
    "property_name": "yearly_salary",
    "operator": "gte",
    "property_value": 45000
  },
  {
    "weight": "custom_property_is_in",
    "value": 0.06,
    "from_entity_property": "desired_work_regime",
    "to_entity_property": "offered_work_regimes"
  },
  {
    "weight": "custom_property_is_in_list",
    "value": 0.05,
    "property_name": "region",
    "possible_values": ["Flanders", "Wallonia"]
  },
  {
    "weight": "custom_property_contains",
    "value": 0.07,
    "from_entity_property": "sectors",
    "to_entity_property": "desired_sector"
  },
  {
    "weight": "custom_property_contains_element",
    "value": 0.04,
    "property_name": "industries",
    "property_value": ["Electronics", "Aviation"]
  },
  {
    "weight": "custom_property_list_overlap",
    "value": 0.04,
    "from_entity_property": "desired_industries",
    "to_entity_property": "industries"
  }
]
​
limit
integer
default:10

The maximum number of entities to calculate matches for. This controls how many source entities will be processed for matching calculations.

Required range: 1 <= x <= 50
Example:

10

​
match_limit_per_entity
integer
default:10

The maximum number of matches to return per entity. This controls how many of the best matching results are returned for each source entity.

Required range: 1 <= x <= 100
Example:

10

​
score_min_threshold
number
default:0.5

The minimum threshold score to apply to match results. All matches with scores below this threshold will not be returned. Due to approximations for fast result-delivery, there might be records with a score slightly lower than the minimum.

Required range: 0 <= x <= 1
Example:

0.7

​
starting_after
string<uuid>

The UUID of the entity to start pagination after. This is used for cursor-based pagination to retrieve the next page of results. Leave empty or null to start from the beginning. The unique ID in your system, consisting of alphanumeric characters, hyphens and underscores.

Required string length: 1 - 100
Example:

"a3903505-eb84-42dc-a79f-5e7b1fe897b7"

Response

OK

​
records
Simple · object[]
required

List of match results.

​
has_next
boolean

True when there is more data after this page.

Example:

true

​
next_starting_after
string<uuid>

The next starting_after value for pagination. The unique ID in your system, consisting of alphanumeric characters, hyphens and underscores.

Required string length: 1 - 100
Example:

"a3903505-eb84-42dc-a79f-5e7b1fe897b7"